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BASIC CONCERTS 


The purpose of this section is twofold: 
ae To define the terms most frequently used in this document. 
b. To describe the actions of OMSII in areas where the DASDL 


description interacts with other components of the system. 


RELATED DOCUMENTATION 


Name Number 
DMSII Audit and Recovery PeSe 2219 0532 
OMSII Reorganization P.Se 2219 9549 


DATA BASE QEFINITION 


Basic Entities 


A data base described in DASDL consists of data items» data sets» 


and sets. A data item ts a fietd which contains varying data 
values. It is the smallest named container of information in the 
data base. Data items may be of various types such as alpha or 


packed decimal. 


Related data items are organized into data records which reside 
in data sets. A data set is simitar to a traditionat data 
processing filer except that the data management system handles 
the mechanics of space allocations record tocation and references 
Cpointers) to other files. Any particutar data record is said to 
be a member of the data set it is in. 


A set is a collection of references to records in a data set. It 
provides a specialized access to that data set. It may» for 
example» provide efficient ordered access by an item in the data 
sets or it may select onty certain members of the data set» 
based on a stated condition. More than one set may be applied to 
any given data set. Each set may include a reference to every 
member of the data set» or it may tnclude references to only 
selected members. If it contains a reference to every meaberer it 
is called a spanning sets Tf It contains only selected members> 
it tis calted a subset. . 
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Atl spanning sets are automaticalty maintained by the data 
management system. Whenever a record is added to or deleted from. 
the data sete OMSIT will perform a corresponding action for each 
Spanning set. Subsets may be either automatic or manual. If the 
condition for inclusion is specified in DASDOL» then the set is 
automatically maintained. If the condition itis not specified» 
then the application programs must insert and remove entries in 
the set. 


In DASDL» data sets and sets are both called structures. Att 
structure names must be unique. Item names within a data set 
must be unique. Howevers tems which are used as keys must be 


unique within the data base. 


Embedded Structures 


Hany data relationships can be represented by a hierarchys or 
tree-structure. In DASDL these organizations can be represented 
by tncluding a data set among the items of a data record. Ifa 
data set does contain another data set as an ttem»e then the 
contained data set is called an embedded data sets» and the data 
record in which it is declared is called the owner or master of 
the embedded structure. Any number of embedded records may be 
under each master. ; 


It is also possible to tnclude sets as items in a data record. 
As with data sets» such items are calted embedded. Most 
coamontlys such sets apply to data sets within the same master» 
but they may also apply to other data sets. 


If a structure is not embedded in any data sets» then it is said 
to be disjoint. . 


The term “master™ refers to a record of the data set in which a 
particular structure is embedded. Sometimes it is useful to-talk 
about not only the master structure» but also the master's 
master, the master's master's masters and so forth. The term 
ancestor is used to refer to any of those structurese up to the 
disjoint master. 
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Manual References 


Some applications cannot be represented as hierarchies. For such 
applications» it may be necessary for a data record to refer to 
another data record without regard to any tree~lLike structure. 
Such areference might te to another record of the same data sete 


or to a record of another disjoint duta-set. It can be a member 
of a manual embedded subset. Manual references provide a network 
capability for describing data relationships. They are 


fiaintained by the application program using a special assignment 
syntax. 


Access Characteristics Which Affect Programs 


There are three tlogical classes of data retrieval» each 
represented by one or more OMSITI structure types. In general» 


changing the type of structure within one access class wiil not 
affect application programs» but changing between classes may. 


ae Unkeyed Access 


In an unkeyed access» data records may not be retrieved in 


any special order. The data set structures. which are in 
this class are standard and unordered; the sets are 
unordered lists. The application program should not infer 


any togical order from the results of "find next" on such an 
access» however» all records in the structure will be found 
exactly once. ; 


be Keyed Sequential Access 


In sequential access» records may be retrieved in order by 
the key specified in DASOL. They may also be retrieved by 
specifying a particular vatue desired for that key. The set 
structures in this class are index sequerntiats crdered list» 
and access to ordered data sets. The application program 
may depend on the fact that a "find next" operation will 
locate the next record according to the sequercing specified 
in the key. | 


Ce Keyed Random Access 


In a random access» records may be retrieved by specifying a 
particular value desired. Sertal access 1S not possible 
with this type of set structure. The set structure in this 
class is index random. 
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QYNSTAX DTAGRAMS 


The syntax presented in the figures and explanations that follow 
conform toa ratlroad syntax as presented in software 


specifications released by Software Documentation at the Santa 
Barbara Plant. 


The main tine of development is from left to right» down on the 
left and up on the right. The beginning of the syntax is 
represented by one arrow (>) and is followed to its termination 
point (#). Continuation tines are indicated by double arrows 
(>>). Untess otherwise noted» optionat entries are expected by 
the program in any order. Variabtes are presented in Lower cases 
enclosed in t&rackets (<>). Upper case entries are required 
syntax. A bridge indicated by (/nN) shows the maximum number of 
times the tine may be crossed. A bridge indicated by (/n«*\) 
shows the minimum number of times that the Line must be crossed. 


ABBREVIATIONS 


Variables may be abbreviated; the following abbreviations have 
been used in this document: 


Variable Abbreviation 
attribute attr 
character char 
description desc 
identifier id 

integer int 
parameter param 
specification spec 
statement stmt 


Syntactic Entities 


<identifier> An identifier consists of uppercase 


alphanumeric characters and single embedded 
hyphens. The first character must be an 
alpha character. The maximum number of 


characters atlowed is 17+ and the tdentifier 
must not cross card boundaries. 
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Legal: | ABC-2 
XXX=XXX 
YZ 
Itlegat:?  30E 
X¥Z~ 
~MN 
abc 
<literats> A literal can be either alpha Ca string of 
Characters), numeric (Ca string of digits)» 


or Hex Ca string of hexadecimal digits). 


<alpha Literals> Alpha literals must begin and end with a 
quote character. They may bce continued on 
subsequent records. The first nonwblank 


character of the continuation record must be 
a quote (") and is not considered to te a 
part of the alpha literal. . 


In order to prevent excessive blanks from 
being placed in the dicttonary file>» data 
base comments may be continued on subsequent 
records in the following manner. A quoted 
string is terminated by a quote = on the 
current . record. If alt subsequent 
characters on the record are blank and the 
first nonebtlank character of the subsequent 
record is a quoter» then the previous string 
is concatenated with the current string and 
stored in the dictionary file. 


A quote may be placed tin a quoted string by 
placing quotes adjacent to each other. 


Input: “Here is how to put a “" in a string." 
Produces: Here is how to put a"™ in a string. 


A null string is represented by "". 


If onty blanks separate two strings» then 
they wilt be concatenated. 


Inputs: “aABC" “DEF® 
Produces: ABCDEF 

<numeric literals> A numeric titerat can be of two types. An 
unsigned integer consists of a string of 
digits not crossing a card boundary. An 


unsigned real is an unsigned integer with a 
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decimat point at the teginning» the ends or 
in the middle. ‘It also cannot cross a card 
boundary. Exponential notation is not 
allowed. 


Unsigned integer: 3894651 


Unsigned real: - 387 
1.245 
681. 
1.0 
0.9 


<hex tliterals> A hex literat must begin and end with an "a" 
Character. All intervening characters must 
be hexadecimal digitss ti.e@e» Or Ll» 2» 3m So 
5» 6» wt» 8» 9» Ar Bo Ceo Dre E and Fe Hex 
literals are an alternate method of 
specifying a character string and may be 
used in the same manner as alpha literals. 


A hex literal must have an even number of 
hex digits. A hex literal may not cross 
card boundaries. 


Examples: 


ae ALPHAC7) INITIALVALUE IS 2130000002 "VAL™3 
be. ALPHAC1) INITYALVALUE IS 8223 
Ce ALPHACS) INITIAL VALUE IS @FQa 2819 aF2as 


<file name> A file name may be of the fora: 


ae <multifile id> 

be. <multifile id>/<file id> 

ce <family name>/<multifile id>/ 

de. <famity name>/<multifile id>/<file id> 


The <family name>» <multifilte td> and <file 
id> way be specif.ied as identifiers or as 
atpha literals. 
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RECOVERAQTLITY 


Iypes of Eailure 


A processing failure such as a Clear/Start may interrupt a 


logical update to the data hbase. For exampler a Gata record may 
have been inserted into a aqata set but not into one of its 
automatic sets. To recover data base integrity after such a 


failures it is necessary to preserve before igages so _ that 
partial operations can be tacked out. 


A storage failure» on the other hand» implies that previously — 
good data has deteriorated. Such failures are usually detected 
by hardware parity checks» though in some cases they are 
determined programmaticatty. Storage failures require a backup 
copy of the data area while it was still sound and a means to 
reconstruct the changes made since that dump. Normally» 
reconstruction is based on the audit trail maintained by the data 
management system» but ir some cases an installation may prefer 
to rerun its apptication programs. 


Audit Irail 


The data management system maintains an audit file whenever the 
audit option ts set in DASOL. This file records “before"™ and 
"after" images of the data» in an abbreviated form when possible. 
No change is written to disk until the corresponding change is 
successfully written to the audit. 


If a processing faiture should occur,» the “*before™ images are 
used to back out the partially completed operations. - *"After* 
images are used also»e to update any good data which had not been 
written to disk at the time of the failure. 


If a storage failure should occur» the after tmages are used = to 
bring some previous copy of the data up=to-date. When applying 
after imagese the data management system must coordinate the 
audit with the state of the data base at the time it was dumped. 


For more detail on this subject see P.~S. 2212 5S47C. 
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Iransactions 
A togicat update to the data base may contain more than one 
primttive data management operation. For example» an update 
might consist of deleting a record from one data set and entering 
it in altered forn into another. DMSIT etlows the application 
program to group such operations into ae tlogicat update or 
transaction. The data management recovery routines are 
transacttonsoriented and always recover to a time when no partial 
transactions are reflected in the data base. A Clear/Start may 
interrupt a transaction; so may abnormal termination of a 
program which was in the middle of a’ transaction. In either 
casep if audit was specified in DASDL»e the DMSII recovery 


routines will Lack up the data base to a “clean™ point such’ that 
no partial transactions are reflected in the data base. 


Restart Program Information 


The application. program must reprocess any transaction which was 
interrupted because of a processing failure such as a 
Clear/Start. To assist the apptication program in restarting,s 
OMSII with record restart information of the programmer's 
choosing. If a failure cccurss» the recovery routines will insure 
that the information corresponding to the last good transaction 
for which the restart area was audited is in a special data set 
cailed the restart data set. Using this informations the program 
can restart at the point to which the data base was recovered. 


The program can detect that restart is necessaryr if: 
ae It discovers that a Clear/Start has occurreds 


b. It discovers that another program caused some of its 
transactions to be aborted; 


Co It is told by some manual method» as when reprocessing is 
meeded after a storage failure. 
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BYLTIPROGRAMAING 


Locking versus JIbcoughput 


One of the most important design gqoats of OCMSII is high 
throughput. To help achieve this goal, a high degree of 
parallelism is provided for in processing against the database. 
The locking strategy helps provide this paratlelisa. 


It has been observed that a typical update operation against a 
database (iee.» a transaction) involves a relatively small number 
of operations and records. In order to provide for the integrity 
of this set of changes in a multiprogramming environment» some 


method of locking must be provided. Locking too many resources 
at one time decreases the possibility of paralielisar and» 
therefore» decreases potential throughput. Locking too few 


resources results in unnecessary overhead and inconvenience to 
the user. DMSII balances this tradeoff by providing record level 
locking. Providing record level locking and allowing all user 
programs to access the database concurrently provides a qood 
compromise between locking too much at once or too little. 


Aborting Iransactians 


The onty lock that oersists for longer than the course cf an 
individual database operation (e.ge» STORE) is the Lock a user 
may:  oplace on an individual record of a dataset. Specifically» 
index tables are not tocked except during the course of a_ single 
database operation. Locking index tables (for examples until the 


end of a transaction) woutd provide the possibility of 
independence o f transactions to the point that the last 
transaction of a single program could be backed out without 
affecting any other program,» but the price paid in loss of 


potential paraltellism is much too great. 


Unlocking index tables as soor as possibler on the other hand» 
atlows maximum parallelism, but causes atl programs’ to be 
aftected it the last transaction of any _one of them must be 
backed out. When aborting a transaction»e att transactions must 
te backed out until a point ts reached at which no program was in 
the transaction state. This Situation maximizes total 
throughput». because aborting transactions is an unusual case. 
The normal case is that no transactions are aborted. In general, 
maximum total throughput is achieved when the normal case is 
optimizeds even at the expense of extra overhead in abnormal 
Cassese 


Because transactions in progress are allowed to complete before 
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the abort process commencese exception processing iS minimized. 
The only verbs at which the abort exceptton need be handled by 
user programs are BEGINTRAANSACTION» ENDTRANSACTION and CLOSE. 


Deadlock 


Record tevel tocking introduces the possibility of deadtock. 
Consider the following sequence of events: 


Program A locks record 1. Program 8B Locks record 2. Program A 
tries to lock record 2, but since program B already has tt 
flocked» program A is blocked (temporarily suspended). Program B 
tries to lock record 1 (which program A already has. locked). If 
program 8 1s btockea at this potnt»s the two programs are 
deadlocked or in a deadly embrace. They are in a circular waits 
each waiting on the other. Ceadlock is a circular waiting 
Situation with any number cf precesses tnvolved such that none of 
the processes can make any progress. 


Besides deadtocks involving Locked records» deadlocks can occur 
involving sync points and tlocked records. For examples, program A 
enters transaction state Cby executing BEGINTRANSACTICON). 
Program 8 leaves transaction state (by executing ENDTRANSACTICN)> 
causing a syncpoint to be pending. Program 8 then Locks record X 
and executes BEGINTRANSACTICN. Since a syncpoaint is pending» 
program 6 is blocked at BEGINTRANSACTION. Program A now tries to 
lock record KX» which program B has tocked. If program A is 
blocked» waiting for a record» the two prosrams will be 
deadlocked because the syncpoint that program B is waiting for 
cannot occur until program A finishes its transaction. 


Internal to the access routines of OMSII-> canonical tocking 
orders and judicious use of the control state are used to avoid 
the problem of deadlock. If any patr of tocks is atways § tlocked 
in Cat most) one order and never in the reverse orders deadtock. 
is impossible. It is impossible for OMSII to try to impose a 
canonical locking order for the user programs to use in tocking 
records. The access routines detect deadtock just before it is 
about to occur. Instead» a process 1s selected from among those 
which woula have been involved in the circular wait. That 
process unlocks alt the records it has locked in the database. 
It then returns a deadlock exception to the user program. 


The process chosen for the deadlock exception is chosen so _ that 


progress 1S quaranteed. Among those processes which would be 
involved in the circular watt» the one process with the lowest 
priority 15 chosen. As the result of a deaalock exceptions a 


process iS guaranteed that all tts recerds are freed» but whether 
or not the process is in. the transaction state is unaffected. 
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Only locked records and syne pecints are considered by the 
deadlock analysis of DMSII. All other sources of waits are 
ignored in the analysis» and it is the user's responsibility to 
see that deadlocks involving cther resources don't occur. If any 
program tn the transaction state is delayed (for any reason) long 
enough» it will eventually be time for a syne point» and from 
that tine one allo new transactions witt be btocked at 
BEGINTRANSACTION until the detayed program finishes its 
transaction. 


When a program gets a deadlock exceptions the access routines do 
not cause an abort» because the program tay not yet have made any 
changese In facts» when possitles the best way for user programs 
to be written is to lock alt records involved tn the transaction 
before making any changes. If any deadtock exceptions are 
encountered» handling them is a simple matter of branching back 
to the beginning of tocking the records. If the records are 
Locked before BEGINTRANSACTION is executed» then even a deadlock 
exception on BEGINTRANSACTION may be handled in this way. 


Consistency 


Every database has a set of consistency constraints. These are 
normally not written down anywhere» but their existence is real 
nevertheless. A phenomenon which is introduced by 
multiprogramming against a database 1s that transaction 
processing routines which preserve these consistency constraints 
when run alone no tonger necessarily preserve them when run 
concurrently. 


As a simple exampler consider the consistency constraint that a 
data item A af record Rl must be equat to data ttem 2 of record 
R2. The following two transaction processing routines (Cin pseudo 
code) preserve this constraint when they are run aione. 


LOCK Ri LOCK R1 

A i= A * 2 A := A + 100 
STORE Rl STCRE Rl 
FREE Ri FREE RI 

LGCK R2 LOCK R2 

Bs= B * 2 B 2= B + 10¢ 
STORE R2 STCKE R2 
FREE R2 FREE R2 


However» when they are run concurrentlyse they may or may not 
preserve the consistency constraint that A=B. For exanple» the 
following execution ‘order guarantees that A is unequal to B upon 
completion if A=B initially» no matter what the initial value of 


i-12 


BURROUGHS CORPORATION COMPAKY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP . BiLe@00/81700 DASDL 
SANTA GARBARA PLANT P.S- 2219 0433 REV B 


A and 8 its. 


LCCK Fl 


A t= A* 2 
STORE R1 
FREE &1 
STORE R1 
FREE R1 
LOCK R2 
B >= B + 100 
STCRE R2 
FREE R2 
LOCK R2- 
B s= B * 2 
STORE R2 
FREE R2 
It is the responsibility of the user programs to use the record 
locking capability of CMSII to maintain consistency in a 
sultiprogramming environment. Before suggesting how this might 


be doner it iS appropriate to discuss a problem which arises tn 
the multiprogramming environment because of audit and recovery. 


Reproducibility 


The transactions which are backed out by OMSII recovery are 


normally reprocessed. However» in a multiprogramming 
environments reproducing the same result obtained for these 
transactions before the recovery 15 a problen. This 1s 
especially true Kxith an online database. Although batch 


processing against a database can often be organized such that 
each section of the database is updated in a single threaded 
moder this is normally not feasible for an online database due to 
the inadequate throughput which would result. 


AS an example» consider an online banking database. Suppose a 
deposit to an account 1s made» and then shortly afterwards a 
withdrawal is made so large that the deposit is needed to cover 
it. After these transactions are processed» a recovery occurse 
and these transactions along with others must be reprocessed. It 
would mnot.be acceptable to cause an overdraft just because th 
transactions happened to te rerun in a different order. 


Uniess precautions are taken by the user application programs in 
what record tocking conventions are folloneds there may not be 
any wayr even single threading the update in rerun mode,» which 
reproduces the previous results Cassuming exactly the same update 
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routines are used and that they do not nake a distinction tetween 
normal mode and rerun mode). The user prograns should use the 
record locking facilities of OMSII to control the manner in which 
concurrent transaction processing routines are interleaved. 


Miscellaneous Locking Considerations 


FIND does not cause the record retrieved to be locked. FINO 
should always be used with carer» because it does not protect the 
results of any decisions made on the record retrieved. 


LOCK (MODIFY) obtains the record exclusively as far as other © 
LOCKers are concerned» but a FIND can retrieve the record» even 
if it is LOCKed. 


When the record itn the user work area is changed because of a 
FIND» LOCKe or DELETE» an implicit FREE on the previous current 
record is performed (Cif there was a previous current record and 
it was tocked). 


STORE does not free the record that was just changed or created. 
This aids in making a consistent set of changes to a coltection 
of records during a transaction. 


ENDTRANSACTION automatically frees all records the process’ has 
tocked in the database involved. This helps make transactions 
independent and tends to help avoid starvation. 


Programming Iransaction Routines 


A good programming strategy in a multiprogramming environment 
should achieve the following goals: 


simplicity 

efficiency 

high totat throughput 

preservation of consistency constraints 
reproductbility during rerun mode 


Assume that it is never necessary to lock more than a small fixed 
number of records. ‘Then the following strategy may be used. 


Step 0: Obtain akl necessary nonsdatabase input information 
needed for this transaction. 


Step 1: LOCK alt records involved in the transaction. This 
includes even those records which are retrieved but not 
altered. FIND is not used at alt. If any deadtock 


1-14 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 


COMPUTER SYSTEHS GROUP BL1800/B1700 DASOL 
SANTA BAKBARA PLANT . P.Se 2219 0433 REV B 


exceptions are encountered» branch to the beginning of 
this step. 


Step 2: Execute BEGINTRANSACTION.} If a deadlock exception is 
. encountered» branch to the beginning of Step 1. 


Step 3: Att transactions at this point are independent of each 
others because they have disjoint collections of records 
locked. Advantage can te taken of this fact for 
reproducibility. One possibility 16 to write the input 
data for this transaction to a global serial transaction 
history file. After a wrecoverys» the backed out 
tansactions would be resubmitted from this file and 
processed tna single threaded fashion. The result of 
this reprocessing should reproduce the previous results 
of each transaction exactly. The transaction routines 
need not be aware of whether or not they are in rerun 
mode 


Step 4: Perform the database updates and execute ENCTRANSACTION. 
Do not free any records. Let ENDTRANSACTION free att 
focked records. 


The amount of processing done in the transaction state should be 
minimized in order to avoid excessive synchronizaticn detay at 


sync point time. Special care shcuitd be taken to avoid 
potentially long waits» such as file ocpenss waiting for datacomm 
input» etcCe >» in the transaction state. One advantage of the 


above strategy is the elimination of potentially tong waits on 
locked records in the transaction state. 


One possible problem with the above strategy is the existence of 
bottleneck records» i.@er records that must be locked by many 
different transactions» because they contain totals which must be 
updated» etc. The problen with such records is that in order to 
avoid a tocking bottleneck they must be kept locked for as short 
a time as possible. 


The above strategy may be modified for such records as follows: 


Instead of locking att records before BEGINTRANSACTIONe tock all 
except the bottleneck records. Define a canonical locking order 
such that they may be locked after BEGINTRANSACTION is. executed 
without causing any deadlocks. The bottleneck records are alt 
locked in transaction state» updatede and immediately freed. The 
point of independence of concurrent transactions is then between 
the LOCK and the FREE of the innermost bottleneck record. 


In the modified strategy as well as the original strategy» FIND 
is not usede only LOCK. Furthermores in both strategies» once a 
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record has been freed» no more records are tockeds and the point 
of independence of concurrent transactions is anywhere between 
the last lock (Cor BEGINTRANSACTION) and the first FREE. Thuse 
both strategies may be divided into two phases. ODuring the first 
phase» records may be locked but not freed» and during the second 
phase records. may be freed but not tocked» and the point of 
independence is anywhere between the two phases. 


This two phase technique has several important properties. If 
ali transactions are two phase tut otherwise arbitrary» then any 
consistency constraints preserved by the routines when running 
alone are also opreserveaq no matter what mix of them is run 
concurrently. Furthermorer no individual transaction routine 
sees any of the consistency constraints violated except as it 
temporarily violates them itself during the course of 1ts update. 
Finally» the point of independerce of concurrent transactions 
between the two phases provides a handie on the prottem of 
reproducibility» § because a serial schedule can be created which 
wilt reproduce the results of the concurrent updates for every 
transaction. 


The two phase requirement 1s not strong enoughs howevers in the 
case that it is noticed that a certain transaction causes an 
abort recovery every time it 18 submitted (due» perhapsr to a 


programming error). In this case» te make any progress» the 
transaction in error must be erased from the global transaction 
history file and not resubmitted. If some of the results of the 


transactions have been displayed on terminals» then there are two 
alternatives to insure that the results of the rerun are the same 


as what has already been displayed. The first ts to not unlock 
any records in the transaction» but to Let ENDTRANSACTION do it 
Instead. This insures that no transactton can depend upon 


another transaction'ts changes until the other transaction has 
executed ENDTRANSACTICNs» and wilt nots» therefore» be erased from 


the transaction history fite for causing an abort recovery. The 
other alternative is to execute ENDTRANSACTION SYNC to protect 
against aborts» but this wittl probably cause unacceptable 


throughput degradation due to excessive synchronization overhead. 


The two phase technique must be modified somewhat when a large 
number of records must be retrieved during a transactione because 
CMSII does not provide a conventent way for a program to keep a 
large number of records Locked. Programmatic conventions must be 
defined such that in order to access a certain class of records» 
a specified record must first oe locked. This technique’ single 
threads access ta the defined class of records. The records in 
such actass are exeupt fram the two phase requirenents» but the 
control record 1s not. An example of this technique is for the 
user to create special control records which are used only for 
Locking purposes. 


ord 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP . B1A00/B817N0 DASDL 
SANTA BARBARA PLANT PeSe 2219 0433 REV B 


QATA BASE 


Syntax: <data base> 


pe ee Oe Oe te ee nn OD Ot Oe OE OF OR BF UF OF OP OF ER OD MS ED OR OD ED Oh OF A OF ED OE OF OD OD On GD HD OF EO at ow ot ae me Oe ee ee a ee »> 


I ] 
| Ct e eemaweem aman awa mena Memes & | 
i { 
bm-/1\7" OPTIONS wenn Cc<option List>) <s"39-= 3 --=>] 
i { 
Pm-/1N-7 PARAMETERS ~- Ccparameter List>) ~- 5 --<=>1 


2 
{ { 
ppesna/i\er= <audit trail> -ccrec- Socaawemneee 3 cemennn>> 
t { 
l==/i«\ <== <data set> sorts ereres Se > |. 
! . ] 
(=s<. <set of GUoSeL> eo - s2 ests ese sees "> 1 
i . i 
fe--- <physical attribute spec> -"c7s---=>] 
| i 
fe-- <remap> -— =o = mon ae anew an as a ws ae ee ee ee =ama> | 
| t 
t-"= <Logical data base> “73s 4 es=<e"->1 


[<r ee swe we nmn man ewes Ld aan enn wane ama ame | 


PISS HAMAS See See eS R SAS SSS eK Sees a SaaS Se See Remar a5 yg 
i . { 
<r eres SS See ee ee ea ae 
i be 
f--- <generate statement> crt 7 steer H=>] 
i { 


[--= <purge statement> e7" ¢ corte nsawem> | 
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DATA BASE OPTIONS 


Syntax: <option tlist> 


] cw ee mw oun ne ss eee , TT OE Benn amen wom or | 


I t 
prea, IT \Ver= AULT], Sees sae 66 see etn ae SS ee eS SS eee SS ae eee SE 

t if i 

P==/1\<"— KEYCOMPARE S*3>[) [Pere= SET s=<*>1 

t i 

teee=™ RESET *2>1 


Semantics: 


Options are used to determine the inclusion of major features of 
the OMSII procedures: 


Ae The AUDIT option allows auditing of the data base. When 
this option 1s used» the data base must include exactly one 
restart data set» described Later. If set» the OMSII 


procedures will maintain an audit trail of changes to the 
data base so that data bdse integrity can be restored in the 
case of processing failures or storage failures. If neither 
SET nor RESET 18s specified» SET is assumed. 


Be. The KEYCOMPARE option allows the system to verify the key of 
a retrieved data record against the key of retrieval. If 
neither SET nor RESET is specified» SET is assumed. 
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DATA SASE PARAMETERS 


Syntax: <parameter list> 


| Cow nw e ww a maw mesma am ee om g Eeaewe wm oe me Sart ew me wee m= weno wm ae | 


peessn/i\o= CONTROLPOINT t= me <int> seer et ern ew enn e noone enn ry 


| : i i 
oe ; {~ SYNCPOINTS >t 
{ 


I--/1\-" SYNCPGINT -- = <= <int> --eeree-- slotetetatatatatatetetatenete | 


! i 
t~ TRANSACTIONS =>1 


Semantics: 


The <parameter tlist> is used to provide certain run-time 


parameters to DMSII: 


A. CONTROLPOINT specifies how many syncpoints should cccur 
between controlpoints.- Default 1s ia syncpoints. 


CONTROLPOINT aoplies only to audited data bases. 


Be SYNCPOINT specifies how many transactions should occur 
between syncpoints. Default is 5 transactions. SYNCPOINT 
applies only to audited data bases. 

COMMEAT 

Syntax: <comment> 

Jf ces awman ae ae we mom met mn ey ce | 
I t 
1 . j 

Peeenan W eon ne 4172Ne> <chéeracter> *-  % sewanenncennace -m mee > 

Semantics: 

The quoted comment (limit = 172 characters) provides a facility 

for including descriptive information in the data base 


description tables. 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BAKBARA PLANT 


bags | 


COMPANY CONFIDENTIAL 
B1600/61700 DASOL 
P.S. 2219 9433 REV B 


AUDIT 
Syntax: <audit traitl> 
yeemeem AUDIT TRAIL terete eters wwsende nna naman ween nen ee >> 
1 ] 
{ i 
>r>ee(C weKs/INe@ AREAS tee we = wee KINTD> serene tere momma nmnm Jo >} 
t | 
I“/INOCMTAREALENGTH ** = 8" <int> -"-- BLOCKS --77>1 
| i 
i-/1Ne= BLOCKSIZE eer. = <= <int> -"- BYTES <--->] 
i i] 
I“/1N7>° FAMILYNAME ~= = ~== <familyname> <-----=>] 
{ { 
t“/iNw-- KIND sesceetee = eememn CISK se ese eww en wenn) | 
| i- TAPE ==>] ] 
{ I~ TAPE? --->1 } 
] l- TAPED ~w=>] ] 
} f= TAPEPE -->1 i 
j i 
4 l 
b=/1N"> SECURITYIYPE 2-8 = |= PUBLIC -<<<--e4-¢==>] 
I i-- PRIVATE ==->1 j 
j ] 
f-/1Ne° SECURITYUSE e"2* = e222 [9 see eteeeecnare) | 
t-- IN <--->] 
t-- OUT ~=->1] 
Semantics: 
Defaults for audit trail attributes: 
A. AREAS is 20. 
Be AREALENGTH is 1006 Blocks 
Ce BLOCKSIZE is 1800 bytes. 
De KIND is DISK. 
ce FAMILYNAME 18 SYSTEM DISK 
Fe The attribute SECURITYTYPE speciftes who>- apart from the 
OWNEeTe may access this file. The mnemonics of the 


SECURITYTYPE attributes are as follows: 
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Ge 


PRIVATE: Implies that onty a privileged user or the cwner 
may access the file. 


PUBLIC: Allows access to any user who references the file. 


The default value for SECURITYTYPE is PURLIC if the 
multitile-id of the file does not contain a usercode. 
Ctherwiser the security attribute of the usercode is used. 
This attribute is applicable only if kind=DISK» and access 
is not through CMSII. 


The attribute SECURITYUSE specifies the manner in which a 


disk fite that is protected ty security may be accessed. 


The default value for SECURITYUSE is I0. The. mnemonics of 
the SECURITYUSE attribute are as follows: 


INS Indicates that read-only access is allowed to the file. 


OUT: Indicates that writeconly access is attlowed to the 
file. 

IQ: Indicates that read/write access is attlowed to the 
file. 


This attribute is applicable only if kind=DISK» and access 
is not through CHSII. 
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Syntax: <data set> 


>e= <data set> ~seeeeeueee sea ennneneanaamanecenmaman=m DATA SET =-->> 
name> ] {1 1 
t-- <comment> -"*> 4% f° CRDERED --->1 
im RESTART --->1] 
I- STANDARD -->1 
I= UNORDERED ->1 


>>=- <record description> s-c--c--- See a ea a SS ae Se a a oS 
{ t 
form » @= <phystcal opttan> -->!] 


Semantics: 


A <data set> description provides for specification of both the 
physical and togicat structure of a file. The different data set 
Structures are: 


A. CROERED 


This structure requires exactly one <access> to define the 
key. Records in each table of an ordered data set are kept 
in physical order based on thel keys Tables are tinked 
together Calso preserving the key order). Alt records in a 
table belong to the same master. Only the one access method 
is permitted. No sets may be assoctated with such a data 
set. This structure must be embedded. 


B. RESTART 


The RESTART data set is a special type of STANDARD data set 
used for audit and recovery. Exactly one data set with its 
description must be designated as the RESTART data set if 
the AUDIT option is specified. This structure may not be an 
embedded data set» and may have NO embedded structures 
within it. 


C. STANDARD 


Records will be placed in a system selected location. This 
structure may not be embedded. 


he? 
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De UNORDERED 
Records witt be placed in a system. selected location. 
Physical tables are maintained in a linked list. This 
structure mast be embedded. Alt records in a table belong. 
to the same owner. No sets or accesses may be associated 


with such a data set. 


The default data set structure is STANDARD. 


DATA SET RECORD 


Syntax: <record descripticn> 


>a 2 


>> == 


eweweerAnrtmeta@gws @2@¢ wwe ow = Semen nen anes he weerta:enws sweets aoaenwweuwsns & sununanwam es >> 


“/1N\o7* REQUIRED ALL soccer enen== wesccenee “-->} 


[<eneceea r woe ee ee mw wo |} 


i t 
( ==" <data Pten> esa se esses es oes eeses eee: J. SoS 
' if i 
I-- <group item> wrrerrr=>f Tee 5 eH] 
{ { 
t--/1\-"<control item> -->1 
i 1 
I-- <data set> reser eern=>| 
1 i 
fe- <set or subset> eer >t 
{ i 
{== <remap> sscceserssewe>{ 


aw aa Ga we a a Semeneeaeaanqaa a mea Ome een uae etaash se we wmnenantawe aaa wwaew a > > 


f ! 
tere Ass5 Seps eee Se wwm VERIFY ~~ C<condition>) -->1 
I i 


{=-- » ia ol | 


t | 
t--"7- <variable format part> -*7-- >I 
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Semantics: 


A <record description> specifies the format of a record of the 
cata set. 


The physical records of the structure associated with the data 
set are referred to as members of that data set. 


REQUIFED ALL is equivalent to specifying REQUIRED on each <data 
item> of the data record. 


The VERIFY clause specifies a condition to be satisfied by items 
in the potential record of a data set. Tf the condition is not 
Satisfied» then the record will not be stored» and.an exception 
returned. 


Data ltean 


Syntax: <data item> 


m=: <data ten oes osereS sees er <data type> =sc ester enen- waman> Z# 
name> ! ' t 1 
7 <comment> =>! I- <item cooees>! 
| option> 


Semantics: 


A <data item> is a field in a record whose value is controlled by 
application programs subject to the restrictions placed oan data 
values by the <item option> clause and the VERIFY clause. 


Data Type 


Syntax: <data type> 


>on @ ALPHA mo os ¢ aman owaen man <integer> me ww oe si aie jew eww ecawwe> ff 
; | 


I i 
" | Icom» omns/tirol t 
t | { { 
t { I i 
t= NUMBER 900 eh se= SeeSee <inteqec> sSsesers) sSssers 2 >t 
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Semantics: 


ALPHA items are stored as EBCDIC characters. The NULL value ts 
alt bits on. The maximum size of an ALPHA item is 8191 
characters. NUMBER items ara stored as 44-bit digits (Ct.e.s» 
packed decimal) with a maximum size including sign digit of 23 
digits (12 if used as a key item). The null value is atk bits 
One 


NUMBER declarations are treated as follows: 
X NUMBER (€S55>%2) 


"XxX" cccupies one digit for the sign followed by five digits for 
the mumber and the decisal point is after the thirc digit. 


Item Option 


Syntax: <item option> 


[ Cee cere ee eee tae mw wee ro meant aumnan mm m= wt = SS eeae en a one | 


seaccejangeve OCCURS ---- <integer> ---= TIMES ----- eee 
reoyieae: REQUIRED ON OR ERIE aE Reem 
ee oe INI TIALVALUE sore meerenee= <lLiteral> eee 
oe 1S => _ BLANKS oe 


Semantics: 


REQUIRED items must be present and not NULL at store-time. The 
REQUIRED ALL option for a data set will make all items REQUIRED. 


INITIALVALUE specifies a means of setting item values at the time 
of creation of a record. Items with INITALVALUE specified wiil 
be initialized to that value on CREATE. If the size of the 
Literat is less than that of the item» the literat will be stored 
into the item tn accordance with COBOL conventions. If the size 
of the literal is larger than that of the item, then an error 
will be given by DASOL. Items with no INITIALVALUE specified 
will be initialized to null Call ones). 


QCCURS causes the item to be repeated the specified number of 
times. The Limit for the <integer> is 1023. 
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Group Iteo 
Syntax: <group ttem> 


>= <group item name> s--sseseeennecernae= GROUP “comes “>> 
: { ! 
I- <comment> -">b 


| ] 
nnn /INeo= OCCURS --- <integer> --7 TIMES --->1 
{ ! 
beers ineeo REGUIRED: SSS Snr es Se eee >1 


J <= eee ee bd en aenaewae | 


2 
t | 
! 1 
>repe—= € ="-= <data item> srcwteseuesacemeewese ) soon aneosaanan> 
i t t I 
i-- <group item> ~=>{ 1-- 3 =7>1 


Semantics: 


<group item>s are alpha items that themselves contain items. 
Items within a group are declared at a level one greater than the 
level of the group. 


Items that may betong to groups are restricted to data items and 
further group items. <group item>s may be REQUIRED or may occur 
a specific number of times. If a <group item> 15 REQUIRED», each 
item in the group is required. group is required. - 


An OCCURS group may contain further OCCURS <group item>s or 
GCCURS <data item>s. However, a maximum of three levels of 
OCCURS is allowed. The Limit for the <integer> is 1023. 
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fLontrol Jtem 
Syntax: <controt ttem> 


x= <control. =<<=<= ae So ep no a - RECORD TYPE -- <data <3" >> 
item name> | i type> 
f=" <comment> “-~>f! 


i 
[m-- FIXEDFORMATVALUE cameron mmnenna= <literal> -=->1 
It { 
Fe- IS “=>f t-- BLANKS ==> 


Semantics: 


A <control iten> is maintained in the record in which itt is 
descrited and it has specific system meaning. 


RECORD TYPE ts required for vartable format records. Its vatue 


determines which format a particular record has. Each data set 
has a max imum of one RECORD TYPE controt§ item. The 


FIXEDFORMATVALUE clause specifies the value that the RECORD TYPE 
field wilt have when the record consists of the ftxed portion 
only.  $If a FIXEDFORMATVALUE is not specified and the data type 
of the RECORD TYPE is ALPHA» a value of BLANKS ts assumed. If 
the data type is NUMBER» then a value of zero is assumed. RECORD 
TYPE is a read onty field. An attempt to modify this field will 
result in a data error. 
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Nariable Format Part 
Syntax: <variable format part> 


Lee eee = eS Sh se Sem a a. ee WS 8 ef 
i t 
t [<2 5° www] ' 
{ { { t 
>>eemcwwew= Cliterat> =" $s *" € == <data sts seeresecer= ) eo---> 8 
t 1 t item> a | I I 
i- » =>] t a | { | 
t- <group => I- + =>! i 
item> ! 
i 
i 


[Cw mmm meme me www ewe me mam eee ee a Renae ee wD ee me mh a 


[none neen-- VERIFY -- (== <condition> -- ) => 


Semantics: 


A KECCRD TYPE control item must be declared in the fixed part of 
the record. The literal specified tn the <variabte format part> 
description must be of the same type as the RECORD TYPE control 
ttem. Each Literal must be unique. 


Each ditferent format is constructed by taking the fixed portion 
of the record and appending the appropriate variable portion. 
The variable portion is selected by comparing the RECORD TYPE 
item with its possidte values as specified by the literal fields 
in the <variable format part> specification. If the RECORD TYPE 
item is equal to the FIXEDFORMATVALUE» the record consists solely 
of the fixed portion. ; 


CONDITION 
Syntax: <canditton> 
>e-= <simple condition> -""<-- eo ee ee ew eee eee nenan=> Hf 


I | 
Im-- AND """" <condition> --~>] 
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Syntax: <stmple condition> 
Pose swewanmonne ( == <conditicn> “= ) =s#s“2e¢ seen em ouee >w 
i t ( . { 
I- NOT ~>1 i { 
I-= <data item ~- <relation> --" <data item -=->1! 
name> { name> 1 


{ t 
f- <Literal> -~->] 


Syntax? <relation> 


Poceasanaaes- SeSSSRteeeS (ECL. Sete ose seas aeaeees ates esse saa aee ># 


Semantics: 
In any simple condition of the form: 
“~~~ <dataenamee1> «-** <relation> -"- <dataename.e.2> “==> 


the data items 1 and 2 must be of similar type (Ceeges 
ALPHA“ALPHAe NUMBER“NUMBER). 


In any simple condition of the form: 
~==— <dataename> -“--- <retation> -“- <literal> s-----> 
the data item and the literal must be of similar type» except in 


the case of ae hex literal which 1s essentially of type alpha. 
The legal combinations are: 
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ae ALPHA - alpha titerat or hex literal 
be GROUP = atpha literal or hex literal 
ce NUMBER = numeric literal 


In cases of alphanumeric compares where <dataename.1> and 
<dataename.2> or <literat> are of different lengthpe the 
comparison is made after extending the shorter string according 
to COGBCL rules. 


Where <datas.name.1> or <datasname.2> is defined within the scope 
of an GCCURS clauser att necessary subscripts must te specified. 


Precedence of operators from highest to lowest» is: 
NOT 
AND 
OR 


Evaluation 1s from tLeft te right with due respect : for 
parentheses. 
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SETS AND ACCESSES 
syntax: <set or subset> 


> wo <identifier> mo an wm ww 2 a om te Gh an Ce me Oe) ae Oe aT BP We EF OE OP OF OD OW Oa on me a a ee a seeanwe,)> 
t { 
1- <comment> ~~>] 


{ 1 a | ii 
t t-- <subset> “<1 t=" pecphysical option> =->f | 
t { 


jf =e e ne awe wan <access> =_ a @ of ws «a sa wonananuanwnanaonwaewnwa wae > | 
Semantics: 


A <set or subset> description provides logicat and physical 
specifications of an access method which will be used in storage 
and retrieval of data. 


A <set> includes one reference for each and every record in the 
associated data set. 


A <subset> includes» in generale references to only some of the 
records tin the assoctated catd set. 


An <access> functions similarly to a set» but may te applied only 
to ORDERED data sets. Exactly one <access> must be dectared for 
each such data set. No physical tables are associated with 
<access>se 


SETS AND SUBSETS 
Syntax: <set> 
pemn= SET OF cm <data set name> --= <key structure> Teese sae eS F 


Syntax: <subset> 


>== SUBSET OF -- <data set serestmennennen= <key structure> --->f 
name> { { 
| [<a orem mews m ens enan | 
r 1 
fe" WHERE =" (*<condition>-) ~=->1! 
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Segantics: 


<set> may only reference data sets dectared at the same _ tevel. 
The set and data set must both be disjoint. 


A <subset> which specifies a WHERE  <condition> is called an 
autotmatic subset. A <subset> which does not specify a WHERE 
<condition> is calted a manual subset. An automatic subset 
includes one reference for each record in the assoctated data set 
which satisfies the <condition>. A manual subset ircludes only 
those references explicitly inserted by application programs. 
Automatic subsets may only reference data sets at the same level. 
Automatic subsets must be disjoint. 


A manual subset may reference any standard data set which is 
disjoint. A manual subset must be embedded. 


Key stcucture 


Syntax: <key structure> 


Poem <Ckeyr> settee es eee ewes em mem ewe owen en newem cus annem n)> ff 
i 7 { 
Cassese Ses See Ses ee: UE Se SS Se] I 
( i I 
P--/1N\e"= DUPLICATES tenner renee tenn nen enna >| 
{ i i i ! 
t= NO DUPLICATES =->1! t i 

7 | i 
P—"/1\cro> INDEX RANDOM sae eerennnnnn>I { 

i- INDEX SEQUENTIAL s--e"--"">1 i 

I | | ; 

{- ORDERED LIST --9--- ennen->! 1 

1 
i 


i - 1 
f-- UNORDERED LIST ~w->1 
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Semantics: 


A <key structure> defines the organization of a set or subset. 
It may include a key on which records may be retrieved. In 
addition,e it may specify the table structures Ce.ger INDEX 
SCQUENTIAL). 


The access techniques avaitable are: 
Ae ORDERED LIST 


An ordered tist ts a collectton of tables... Entries within 
the table are ordered on key. . 


Each table entry consists of a key and an address. 
Tables are Linked together. 


This structure may only be used for manual subsets with a 
Ckey>e 


8. INDEX SEQUENTIAL 


Coarse table entries point to fine tables or other coarse 
tables. Fine table entries point to data records in the 
assoctated data set. 


Entries within both tables are in sequence on key. 


When a table becomes full» the table is split into two 
tables» based on the SPLITFACTOR. Refer to <physical 
option> under Physical Attribute Specification. 


Table entries consist of a key and an address. 


This structure may onty be used for automatic subsets’ and 
sets. 


Ce. INDEX RANDOM 


MODULUS represents the number of bastc tables in the set. 
Refer to <physical option> under Physical Attribute 
Specification. 


A hashing algorithm is applied to the symbolic key to obtain 
abasic table number in which to tocate the table entry. 
The table entry consists of the key and address of the data 
record. If the selected basic table ts full» an overflow 
table will be used. 
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This structure may only be used for sets. 
De UNORDERED LIST 
An unordered list is a coltection of tables. 
Table entries consist of addresses onty. 
The tables are linked together. 
This structure may only be used on manual subsets without a 
<key>. If only one entry has been tnserted into the manual 
subsets» then that entry is carried in the parent record (Cno 
list tables are allocated). 
The ordering of duplicate key records is unspecified. 
Default organization for sets with keys ts INDEX“SEQUENTIAL for 
disjoint sets or automatic subsets» and ORDERED LIST for manual 
subsets with keys. Default organization for manual subsets 
without keys is UNORDERED LIST. 
NO DUPLICATES is the default for atl sets or subsets with keys. 
DUPLICATES must be specified on any automatic subset with keys. 
Key 


Syntax: <key> 


>" KEY ener aeeaesnmese= <key NAME> =H eres Seem ewnwe nena enemas ># 
{ tt 1 tl 
t-- IS -->1 1 I-- ASCENDING ~~ >! 
! 1 { 
Caen eee | I-- DESCENDING ~=>1 


i 

i 

i 

i [ceemee ne eren 4p ce weennnnnncnen| 

i 

Lesa Cer] hey Nane> HSSSe esses sSe sere SeH =.) HHS 


t | t 
f-~ ASCENDING -~->1 
‘ - 4 
i~=- DESCENDING =>! 
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Syntax: <key name>. 


>wVrt Nee eB ee ee oO wm oe 


<data 


Semantics: 


item name> 


<group item name> 
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Meee Pee We EBT aw Seeman a a > # 


<controt item name> «-->] 


Each key name in a key must refer to an item in the data set on 
uhich the set or subset is declared. The default ordering of 
records 31s keys ascending. Subscripted ttems may not be used as 
keyse Numeric data items in a key are restricted to 12 digits in 
length. Key items are taplicitly required. 
Index Random sets may not have descending key items. 
ACCESSES 
Syntax: <access> 
>>== <key> ES Ae SS a eS SO eR NS Se a ore ee a ea ee ae m= amo 2 > 
i { i t 
Les <9. Set powcewece= CUPLICATES ~-<<>1 
t i 
{-- NO <3 
Semantics: 
Ones and only oner <access> must be dectared for each OREERED 


data set. 


Accesses | be dectared for 


ORDERED. 


may not 


any type of dataset except 


NO DUPLICATES tis the default for accesses. 
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PHYSICAL ALIRISUIE SPECIEICATION 


Syntax: <physical attribute specification> 


>ee= <structure name> ="-" (€ == <physical option> -- ) serrrrr=>F 
f 1 
Im <data base name> ---" ( == <database physical> =" ) ="=>1 
opt ton> 


Semantics: 


<physical attribute specification>s are used to specify the 
physical structure of the data base. 


They allow the user to place alt physical attributes at the end 
of his DASDL source input and must refer to structures that have 
been previously defined. 


Any option appearing in a <physicat attribute specificatiaon> wilt 
override the same option which was specified in the structure 
definition or a preceding <physical attribute specification>. 


The <physicatl attribute specification> may be declared at the 
disjoint level only» but may refer to embedded structures. 


The <data base name> may be that of the physical data base or one 
of the Logical data bases. . 


COKPUTER 


BURROUGHS CORPORATION 
SYSTEMS GROUP 
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Syntax: <physical optian> 
J Crete cer em wet wena ee mee ? Saewmenmreae SB eR ee ee ee Ce ee ee OU 
i \ 

peeen/1Ne= AREAS wemeren= = -9" <integer> sotsrecerrsrt en ennnn->F8 
l ! 
bm-/LN-- AREALENGTH «°° = “2° <intoger> -<- BLOCKS crete" >) 
t 1 
bem /LN77 FAMILYNAME =<" = 2" <familyname> seers ercere= >{ 
i . i 
fer/1i\-- MAXENTRIES SE ae Ee <integer> causa moon aman ae > | 
( j 
b--/1\-- SPLITFACTOR -~ = <"- <integer> --7--- waren nen =>] 
i | 1 
Pm-/1N\7°* MODULUS coset = "= <integer> crea ssweeaeerenan>| 
t 1 
be-/iNe7o* BLOCKSIZE sree = =" <integer> c-"™ RECORDS “e777 >1] 
| i i ] 
‘ i~ ENTRIES =>! | 
i ! j | 
i t- TABLES <-->] i 
i i 
Len JINTe PRIME steer rene nen ence cen nccernnen tower ewe en ann -->1 
l i 
be-/1N-" MAXRECORDS “25 = “2 <integer> “sss es esannwenen>| 
y i 
be-/1iNe" TABLESIZE cer- = <== <integer> rr ENTRIES c---->] 
‘ , i 
P--/1N7" TITLE eececes=s = em~ <file name> ocr esscaemewannn)> | 
i { 
P—-/iNn= SECURITYTYPE =" = t27 PUBLIC stecet ers eren nn mnnn>] 
i i- PRIVATE ~~> 4 I 
y { 
f= 71 NE". SECURTIXNUSE “e@ ee 10> Sess e2 Swen en ewnncnaae > | 

t- IN «--->1 
i- OUT <-->! 
Syntax: <database physical option> 


Sasuse SECURTIYGUARD “<> = See < ti leo name> -Seaeecssesteseree= a5 9 
Semantics: . 


The <physical option> provides for specification of the physical 
attributes of a structure. There are four types of physicat 
structures: standard data set» index sequential access» index 
randon access»e and List. Note that not all options are 
applicable to all structure types. The applicable structures are 
indicated in parentheses. 
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A. AREAS 


B. 


This attribute specifies the maximum number of areas in the 
disk file. This attribute may be specified for all types of 
structurese: Its vatue must be drester than ¢ and tess than 
or equal to 105. The default ts 290 areas. (€S0Se I/Se I/Re 
LIST) 


ARE ALENGTH 


This attribute specifies the maximum number of physical 
blocks to allocate per area on diske (C(SO0S» I/Se I/R» LIST) 


BLOCKSIZE 


This attribute specifies the blocking factor for the 
structure. The applicable units are dependent on the 
structure types records for standard data setsr entries for 
index sequential and index random and tables for tists. 
(SOS I/S» I/Re LIST) 


FAMILYNAME 


This attribute specifies the pack identifier of the file 
containing this structure. The reserved word PACK 15 
synonymous with FAPILYNAME. The <familyname> may te 
specified as an identifier or as an alpha literal. This 
attribute is applicable to ali structure types. The default 
is the object pack id from the compile statment. (SDS» I/Se 
I/R»e LIST) 


MAXENTRIES 


This attribute specifies the maximum number of entries that 
may be enrolled in a set or subset. (C1/5S» I/fe LIST) 


-MAXRECORDS 


This attribute specifies the maximum number of records that 


may be enrolled in a data set. (€SD05» LIST) 


MODULUS 


This attribute specifies the hash=modutus to be used in 
providing the table number for the start of a search (Ci.e., 
the number of base tables). (CIR) 
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He PRIME 
When used as the attribute of a sete this attribute 
specifies that this set is the primary access method for the 
data set. The OMSII system uses this characteristic to 
optimize the file organization of the data base. Only one 
set may be specified as prime. A- prime set must have the 


I. 


Me 


same number of areas as its data sete. CI/R» I/S) 
SPLITFACTOR 


Used for tndex sequential and index random structuress this 
attribute specifies by percentage the maxianum number of 
table entries to be split into a new table when the table 
$size as exceeded. The minimum number 1s 
(100% ~- SPLITFACTOR).j (CI/Se I/K) 


TABLESIZE 


This attribute specifies the number of entries per table for 
list structures. (LIST) 


TITLE 


The TITLE attribute specifies the name of the file on disk. 
The default for the TITLE IS «default pack>/<data base 
name>/<structure name>. 

SECURITY TYPE 

See AUDIT (Section 3) for details of this attribute. 
SECURITYUSE 

See AUDIT (Section 3) for detaits of this attribute. 
SECURLTYGUARD 


The SECURITYGUARD attribute specifies the name of a file on 
disk to be used to specify the security constraints on the 


data base. If SECURITYGUARD is not specified for a given 
data basep the access to that data base defaults to 
unrestricted. See SECURITYGUARD (Section 7) for a 


description of the format of a Securityguard file. 
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NEEAULT VALVES | 
Default values are computed for each applicable option if no 
explicit value was specified via a <physical opttion>. If 


explicit assignment is made» then the DASDL compiler wilt not 
change the assignad vatue. 


STANDARD DNATA SET 


@e AREALENGTH = MAXRECOROS/BLOCKSIZE/AREAS 


be BLOCKSIZE = £1 RECORDS or the maximum number of records 
that will fit into 14490 bits. 


Ce WNAXRECORDS = 10000 


LIst 
CUnordered Liste Ordered List» Unordered Data Set» Ordered Data Set) 


@e AREALENGTH = MAXENTRIES/TABLESIZE « 
PARENT. POPULATICN/BLOCKSIZE/AREAS 


be. BLOCKSIZE = 1 TABLES or the maximum number of tabtes — 
that wilt fit into 1449 bits. 


Ce MAXENTRIES Cor MAXRECORDS) = 10 
de. TABLESIZE = 1 ENTRIES or the maximum number of entries 
plus the requisite control information that 
wilt fit into 1440 bits. 
ANDEX SEQUENTIAL ACCESS 


@e AREALENGTH = 1.2.4 * Cnumber of blocks necessary to represent 
the population) / AREAS 


be. SBLOCKSIZE = Square root(MAXENTRIES) ENTRIES 
ce WMAXENTRIES = population of the data set 
de Not PRIME 


@e SPLITFACTOR = 75 
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INDEX RANDOM ACCESS = 

ae AREALENGTH = 1.3 * CHOOULUS/AREAS) 

be BLOCKSIZE = 1e1 * Square root (MAXENTRIES) ENTRIES 

ce MAXENTRIES = population of the data set 

ds. MODULUS = 1.2 * CMAXENTRIES/BLOCKSIZE) ENTRIES 

e. Not PRIME 


f. SPLITFACTOR = 75 
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SECURTITYGUARD 


The Securityguard file is used to specify to the OMSII system a 
list of users (usercodes) who may access a gqiven database and 
what type of access is permitted. This file is read by DASDL 
during the compilation of the data base and the access 
information is encoded into the OASDL generated dictionary. For 
this reesone changing the securityguard file after the DASOL run 
does not affect the data base access criteria. The access 
security provided by thts mechanism only restricts access to the 
data base files via the OMSII system. Access of the data base 
files ty any other means is handled by the regular MCPII file 
security rules. 


Syntax: <contents of securityquard file> 


TET LITTLE TLL TTT TT LL ae ee ae ee a ae ae oe om on om an > > 


Prer= DER AULT Sh > ce See NO Sse ese ees. ip: Se 
i i 
i= RO. se se>4 
4 ! 
Pee Rh oes e>| 
aa a a aa aa ee a a | 
{ ; : ! 
L hisses eee a eS Se ee eee 
1 | i of 
Pecenem USERCODE = <usercode> =“7"~ NO see § one>>] 


t | 
i-- RO <->] 
| j 
f-- RW <-->! 


Semantics: 


A "Z" at any point =itn a record denotes that the rest of that 
record 15 4a comment. Only columns 1°72 of a record are scanned» 
and any other columns are ignored. ; 


There are 3 access privileces. NO specifies that any attempt to 
open the database will be cented. RO specifies that Read Onty 
(Inquiry) opens witl be atlowed. RW specifies that Read Write or 
Read Only CUpdate or Inquiry) will be allowed. . 


The DEFALLT statement provides the Database Administrator with a 
means of letting OMS know whether or not to approve database 
opens requested by jobs running under a usercode mot tisted in 
the Securityguard filer or by jobs not running under a usercode. 
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If there is no DEFAULT statement, then no access will be 
permitted except as specified by any subsequent USERCODE 
Statements. This is the same as OEFAULT=NQ;>. The option 


DEFAULT=RO> will allow any job running under a usercode that was 
not specified in the Securttyouard file Cor a job not running 
under a usercode) to open the database Inquiry. Cther open 
rights may then be specified in subsequent USERCODE statements. 


The option DEFAULT=Rke allows any job to open the database 
Inquiry or Update. The Database Administrator may then list the 
exceptions to this by adding USERCODE statements Limiting access 
privileges for specific usercoces. 


Usercode statements are the exceptions to the DEFAULT statement. 
A USERCODE statement is used to tell OMS that a certain usercode 
is to have access rights that differ from the access rights 
specified by the DEFAULT statement. It makes no difference if 
the parentheses are included with the <usercode>. If they are 
omitted» DASOL witl supply then. 
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REMARS AND LOGICAL DATABASES 
REMAP STATEMENT 
Syntax: 


>a <remap name> ae ee ee ee ee ee ee ee ee ee REMAPS nm <data set =u >> 
I i name> 
{[-- <comment> ~~>1 


> > a0 on oe me on et ee ew 8 mm ae oe ar ae ee ee Oe a te we on ee 8 Oe OY 0D ae on we ee ee ee ee aaa a a a >> 


t 
[Keer cennwrn renner 4p cere n nn nnn een ennn econ ennnn| 
i 1 
Peee/iNen REQUIRED ALL sect m nner serene nn cnen enna] 
i | : : { 
bem-/1Ne-" READONLY ALL ------- on cen eenemecnensn=>| 
i? et t 
(-- NO EXCEPTION -9-"--~>1 
{ ! 
t-- GIVING EXCEPTION -~=>1 


> yy wan wren een <remap record description> enna nnreaetaeananmn ean a = ># 
Semantics: 


<remap name> specifies the name given to this remap af the <data 
set name>» which must be previously specified. Application 
programs may then refer to the <remap name> as tf it were a data 
set. 


REQUIRED ALL is equivatent to specifying REQUIRED for each iten 
of the remap record. 


READONLY ALL 18 equivalent to specifying READONLY for each ttem 
in a remap record. An exception wilt be returned to the host 
program if READONLY. fields are modified» unless NO EXCEPTION has 
been specified. j 
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Remap Record QOcscription 


Syntax: <remap record description? 


1 1 t ! 
fom 5 ==>{ {- <remap record ~>] 
option> 


> > 2 we ote om on ce a em oe mn ee wo mn 8 Ok Dm ON ae we a mt On OE OD OF ee oe on oe on mee ee aunenn aan mannocwawe > # 


1 { 
f--"- <remap variable format part> ~e~>1 


Semantics: 


The <remap record description> provides a means to specify the 


format of records in the remapped data set. Items must have 
appeared in the same part (fixed part or variable part) of the 


original data set. Any and ali items from the original data set 
may be omitted from the reap. b < 


Remap Record Option 
Syntax: <remap record option>- 


J < wn e enna ae mm =e ae Pte es SB ee Rea REE BWSES UH EHS u_gvwasws FITS aa a | 


peren/L\-c0e- eemcmee VERIFY “== ( =2" <condition> <<" ) --9--->% 
\ ot i 
Pomp met i 
i | 
Pa-/1\ cree enon ne -- SELECT “== ( "=" <condition> --- ) <->! 
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Semantics: 


Cnty records satisfying the SELECT condition will be returned to 
host programs. 


For STORE statements» records must meet both the VERIFY condition 
in the remap record description and the VERIFY condition in the 
original data set description in order to be storec in the data 
Set. 


Remap Variable Eormat Part 
Syntax: <remap variable format part> 


| Cw ee wma sc wen ew aw ee Bee we we em oe @mate @& Vesa onan wwe wa aam aa ms | 
Perret enewwwomnae Ciiteral> ~"* 3: “= <remap variable format e-+*-+-> ># 


i i description> 
{-- , ~m> | 


Semantics: 


Allows specification of the variable format. portion of the remap 
data set record. The <tliteratl> must match a <titeral> in 
variable format specificaticn of the original data set. The 
RECORD TYPE item from the original data set must have been 
remapped in the fixed format portton of the remap record. 


Remap Variable Eormat Description 


Syntax: <remap variable format description> 


[ <cHmona ; onan wa aw | 


t 1 
>=~ ( *-" <remap item> s“1steeee"" seas a es Sse eS Se enieS === ># 
t { ! i 
f-- 3. °~>] I-- <remap record ~=->] 
option> 
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Semantics: 
items 


Only appearing 


original data set may be included 


Remap Iten 


Syntax: <remap item> 


> Few a waw wow we @ os 


<remap 
<remap 
<remap 
<remap 
<remap 
<remap 
Semantics? 


Items from the original 
set through the use of 


B<-4& 
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in variable formats of the 


in such a declaration. 


appropriate 


control ttem> 


data set> 
subset > «secre sae cecceae eres 
data item> 
Can aet ew onws easement ane | 


group> 


regrouping> 


data set 


are included in the remap data 
the renap . 


item. 


item> 


asa ete enraa nana DEB OO Bmw eam awasewewanwaawaae > ff 


Remap Control ten 
Syntax: <remap control 
>=-==— <control item -7- 
| name> I 
{ | 
t 
t-- <remap control -- 
item name> t 


“= <comment> <-->! { 
{ 
Se ee sense Sateewess oS Ss. <controt ==> 
i item name> 
<comment> -->1 
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Semantics: 


The <remap control item> allows control items from the original 
data set to be included ir the remap. If a new name is desired 
for the <remap control item> then the <remap control item name> 
option may be used. The <remap control titem name> must be unique 
in both the original data set and the remap. A control item may 
be remapped only once in a given remap. RECORD TYPE control 
items must always be remapped. 


Remap subset 
Syntax: <remap subset> 


i t-~ <comment> <-=>1 . t 

t 1 

i I 

fe~- <remap subset secercscereserenmenne = <Csubset name> «~>1 
name> 1 t 


I-- <comment> +->} 


> Pe PA ene m meme n mw e nam enenmaemanen ema anem nnn nna aweman> ¥ 
I t 
poe") OF ‘eres <date- set nage> SHsesanes sees sree =>] 
1 1 
(=" <fetap Nate. Soe S sess esse sesee ens | 


Semantics: 


The <remap subset> atlows the inclusion of manual subsets in a 
remap. The object data set may be specified optionally. If the 
object is a remape then it must be a reman of the criainal object 
data set. If anew name is desired for the <remap subset> then 
the <remao subset name> optior may be used. The <remap subset 
name> must meet the uniqueress criterta for structures. 
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Remap Data set 
Syntax: <remap data set> 


>; eon <remap name> 2 on ee Ge an Ow me me OD Et 0 OF OP On OD OD Gr On ne OF Oe. Um OL ee om en Oe oe ee en Ot Os a ee on SS 


t l-- <comment> ~=->1 i 

I | , 

{- <renap data qe sts ew ec ene emaamae = oe <remap ~cc7>] 
set name> t - t- name> 


f-- <coamment> ~->] 


i ! 
f=" <sel. part> “Sess es"e> 4 


Syntax: <set part> 


Pet CTR ALL wetter wen we cee cn nnn ne cnn mene enw necnecnnen=) -->7 


b= NONE S255 es<F see eee ener Sess SS eSeie See ee ose) ] 
j I 
i ot tee ae | 
i i . i I 
b=< SETS SS sesesoer eee sates ssessee=: <set or -es=51 


I . { subset name> 
i-- <remap set *7 = =*>] 
name> 
Semantics: 


The <remap data set> allows the inclusion of a remap of an 


embedded data set in the remap. The remap of the embedded data 
set must have heen declared in the originat data set. The <remap 
data set name> option atltows renaming of the remap. The <remap 


data set name> must meet the uniqueness criteria for structures. 
A remap may be tncluded orly once in a given remap. 


The optional set part allows inclusion of atl» none or onty 
specified sets and subsets in the remap. The sets may be renamed 
With the <remap set name> option. The name assigned to a set 
must meet the uniqueness criteria for structures. If the set 
part is omitted» then ALL 185 assumed. 
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Renap Data Item 


Syntax? <remap data item> 


>=== <data item name> wert ser renee ence eene SSCS NSH Se Se Semen S >> 
{ | { { 
I I-- <comment> ~~>{ { 
{ i 
f-- <remap data cee et ese stereo eweewwe = m= C<data item “> 1 
item name> { t name> 


I-- <comment> <=>! 


i t 
i--- <remap data item option> «----=>] 


Semantics: 


The <remap data item> allows data items from the original data 
set to be included in the remap. If anew name is desired “for 
the <remap data item> then the <remap data item name> option may 
be used. The <remap data item name> must be uniaque in both’ the 
original data set and the remap. A data item say be remapped 
only once in a given remap. 
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Reman Data Item Qntion 


Syntax: <remap data item option> 


i<“seee = ae as ww mame we a , Sanne ew eee me | 


SS eee Se ee eames, Tes TNITTALVALUE. Seer eereee== BLANKS =o s"= >f 
| a | t : {i H 
t- <data -o>!1 t. t- 189 -=>t t- <literal> =~] 
type> i . 
M7 INS HDD EN <9 Se 4558 4 Se Ses SSeS e se eae Sse > 
{ i . i 
f= READONLY. S22 e""= A ee >I 


{ 
t 
t te= NO EXCEPTION “esees"=<>{ 
{ I ! 
§ t-- GIVING EXCEPTICN =~--->1 
i 


LLIN = RECULERED. Sta SS te rare eee eee Sree 4 
{ i 
L“FIN@ = CECURS == <integer> = TIMES: es*s=-=<== >4 


Semantics: 


The <remap data item option> is for the purpose of respecifying 
the options for the data item being remapped. Any option which 
is not specified will default to the value of the original item's 
option. 


If <data type> is specified» it must match exactly the original 
description Cit is for documentation purposes only). 


If the OCCURS option is specified» the value of the <integer> 
must be less than or equal to the original declaration. 


The HIDDEN option documents the absence of a field from this 
remape The HIDDEN field does not exist in the record presented 
to the user, howevere an INITIALVALUE may be specified» and the 
system witt initialize the fieid on a CREATE. HIDDEN items may 
also be used in SELECT and VERIFY conditions. 


The READONLY option specifies that the item may not be altered by 
the host program. If such a field ts alteredre an excepttoan will 
be returned to the host programe unless NO EXCEPTION has been 
specified. 


The INITIALVALUE and REQUIRED options are identical to the 
options for data sets. <remap data item>s which are REQUIRED in 
the original data set are always checked for presences regardless 
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of whether REQUIRED is specified or not. The INITIALVALUE 
specified for a <remap data item> will have precedence over an 
INITIAL VALUE for the original <data item>. 


Remap Group 


Syntax: <remap group> 


>"="= <group Name> qe ses annonce Se Oe OO a a ee a >> 
| { j | 
| i-- <comment> -->1 ! 
| 1 
i-- <remap group *se"4eeee%-"%5 aa maim emia a aS. Car ou os ol 
name > i 1 name> 


I-= <comment> -->|] 


>> OF ow ee oe en ee a we es oe ws ot os ee ee ee awanmwea oo = HBO GS MH ee 8 Se a ee ee ee ea Sq nenneneanawes = ># 


l if ee | 1 
i-- GROUP =">1 tem <remap -">1 Ler <remap group c=>1 
group. description> 
eption> 


Semantics: 


The <remap group> attlows group items from the original data set 
to be included in the remap. If a new name ts desired for the 
<remap group> then the <remap group name> optior way be used. 
The <remap group name> must be untque in both the original data 


set and the remap. A group may be remapped onty once in a given . 
remap. 
If the <remap group descripttaon> option is not used» then’ alt 


subfields of the group are inplicitly remapped. 


8-10 


BURROUGHS CORPORATION COMPANY CONF IOENTIAL 
COMPUTER SYSTEMS GROUP BLEOO/BL7OC DASOL 
SANTA BARBARA PLANT P.Se 2219 0433 REV B 


Remap Group Qpkign 
Syntax? <remap group optican> 


[<< ee we we an en ae ee oe oa a 2 an oe , oh me 8 et on oD ee ee ee mame | 


| 
| ; 
oe | : 


f-"/1\-°" HIDDEN -"<--- ween w ewe eens wenn anee> | 
i i 
I- READONLY soem eee t nnn nnn eee nn nen ee ==> | 

\ ' 

I-- NO EXCEPTION ----<- >I 

i i 


I-- GIVING EXCEPTION -->1 


Semantics: 


The <remap group option> is for the purpose of respecifying the 
options for the group being remapped. Any option which is not 
specified with default to the value of the original group's 
option. 


If the OCCURS option is svecifieds the value of the <integer> 
must be less than or equal to the ortginat declaration. 


The HIDDEN option documents the absence of a group item and att 
its sub items from this remap. The HIDDEN group item is not in 
the record presented to the user. HIDDEN items may te used in 
SELECT and VERIFY conditions. 


The READONLY option specifies that the group item and ail its sub 
items may not be altered by the host program. If such fields are 
alteredr an exception will be returned to the host programs 
unless NO EXCEPTION has been specified. 


The REQUIRED option is identical to the option for grouo items. 
Items which are REQUIRED in the ortginal data set are always 
checkea for presence. 
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Remap Group Description 
Syntax: <remap group description> 
; =-e==< or mmaee { 
{ | 
pm ( 2" <remap data Ttem> wwe senre amen ecnewnn ) weeeennnnn= >t 
i j i { 
{- <remap group> wanwuewan> | {-- , w~a>] 
1 1 
I~ <remap regrouping> ~->1| 


{ Kwame =~ ane 


Semantics: 


The <remap .qroup descripticn> atlows for the redescription of 


items within a group. Onty items which are declared in the 
original group may be remapped in the <remap group description>. 
All items must -he respecified such that their number of 


subscripts does not change and the sizes of all subscripts do not 
exceed the original declared sizes. 


If the <remap group descriptiaon> is omittede alt items in the 
original group will be remapped without change of name or 
options. 


\ 


Remap Regqrouping 
Syntax: <remap regrouping> 


>ere= <remap regrouping nare> = "="" GROUP wenrreereem ain asians aid 


>> sme wean senweann an = wnweneens es a SBeawewneewrtwaeeeea & we anneBpe faa = ga ee @ounwewannaaws = ># 


1 
fuse secereeeso =e" <rerap group opntion> “=<-<= <<= == i 


[cca wwe we we , com on ewe mw | 


i { 
>>="= ( -""-= <remap data item> eset esr seen emeenasaae ) enae=>F# 
| 1 i j 
l-- <remap group> sree =>I l=" 5 ==>] 
i i | 
I-- <remap regrouping> --22>] 
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Semantics: 


The <remap regrouping> allows for restructuring of the data in 
the remap. The <remap regrouping name> must be untque in both 
the original data set and the remap. 


The GCCCUKS option must be specified in the <remap gqroup option> 
such that all itens remapped in the <remap regrouping> have the 
same number of subscripts as the items in the original data set 
and the sizes of all subscripts do not exceed the original 
declared sizes. 


LOGICAL DATASASE 


Syntax: <logical database> 


>“-= <logical database name> ecrerttecmrerestereern=s DHATABASE o7>> | 


] ! 
t-- <comment> ->1 


>> == ¢ m= €structure list> -- ) wm AOR EKRenaneaan a wee Dw -s>> 


PPA AM mnenmana nanan arena www ewan Sw ewe enw eee enn em ee eene > ft 
i | ! 
I--- SECURITYGUARD = <filename> --->] 


Semantics: 


The <togical database name> specifies the name of a-° togicat 
database. <tcogical database2%5s control which database structures 
can be accessed and how these structures can be used. KHhen 
<logical database>s are deelared in ODASDL> the <data set>sp 
<remap>se <set>s»e <subseto>s and <access>es which are to he 
included in each <logical database> are listed. Host language 
programs may invoke structures selectively from a <tLagicat 
database>. Programs can only use the structures ccntained in the 
<lLogical database> they invokes thus the database administrator 
may controt which «structures are accessed by controlling which 
<logicat database> is used. 


A SECURITYGUARD file may be assigned to each <logical database>. 
The Securityguard fite specifies who may open the <togical 


database> and how they may acaess tt. The Securityguard file is 
read by OASOL when the database 158 comptled and the acress 
restrictions are recorded in the dictionary. See SECURTTYGUARD 


(Section 7) for a description of the fornat of a Securitycuard 
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Structure List 


Syntax: <structure List> 


» alana Ea ey ia wee ee ase ~ <dataset name> «ere-2 Se ee ne oe ae See ># 
i { 4 oe | i 
fe~ <structure = ~">1 J" <remap name> -->1 le=- <set =s2-"">] 

name> part> 


Semantics: 


The <structure list> specifies which <data set>s» <remap>s-p 
<set>sy» <subset>s and <access>es are to be included tn the 
<logical database>. 


The <structure name> option changes the name of a <data set> or 
<remap>. When the <logical database> is invoked and listed in a 
user program» the new name replaces the origtnal name. ALl user 
programs which invoke the <logical database> refer to the 
structure using the new names 


Alt <cata set>s and <remap>s named in the <structure tist> must 


be disjoint. If a <data set name> is specified» alt of its 
embedded <data set>s are automatically included in the <togical 
database>» and embedded <remap>s are excluded. When a <remap 


name> is specified» the embedded structures named in the <remap> 
are included in the <logicat database>. 
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Syntax: <set part> 


PT CFP ALL tee erence erence nee nen a wonen--- weer eennennn-- ) ->¥ 
t . ; i 
i NONE Me ee ee et ee oe ee OF ot Se oh ee ae a SD a em oF 8 a oD oe os oe sea eae aaa 0 
i . \ 


i | io 
Im SETS sewer erence ne= women ereees <set or tenet en 


{ { subset name> 
I" <set name 7 = =>4 
nare-2> 


Semantics: 


The <set part> specifies which disjoint <set>s» <subset>s and 


<access>es are included in the <logical database>. If the <set 
part> is not present,» or if ALL is stipulated» all disjoint 
<set>s» <subset>s» and <actess>es are included. If <set>sp 


<subset>s or <access>es are specified» they must refer to <data 
set>s or <remap>s which are inctuded in the <logicat database>. 
The <setename.2> option can be used to change the name of a 
<set>» <subset> or <access> in the <lLogical database>. 
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REORGANIZATION STATEMENTS 


The reorganization statements are part of the generat 
reorganization capability of the OMSIT system. For more detattls 
see the 81800/B1700 OMSII Reorganization document» PS. 2219 
0549, 


GENERATE STATEMENT 


Syntax: 
2@ GENERATE -«= <set or subset name> “=< see+eee=e SSeS Sew e =<-\>> 
{ ] 
i~ <data set om a On on em a ow oe ow ae on nase aumeannacwasaonam > | 
nama> r . { 
{- ORDERED BY -- <set ----->1 
name> 


>> Fer me ewan BB ee Tee we ee ee a2eenme wa Swe ees aauannmweaae a rnmeaenmauan Se @ owen >?f 
| | 
Pees (=~ FAMILYNAME -- = <familyname> ~~") -=>1 
Semantics: 
The GENERATE statement causes the system to garbage collect the 


structure specified. The GENERATE statement may only be used if 
the SREORGANIZE option is set. 


PURGE STATEMENT 


Pee PURGE, eee SSCP uc Cure. Vase. Sess sore SSS eee ee pata ls 
Semantics: 
The PURGE statement causes the system to remove all elements from a 


structure. The PURGE statement may only be used if the SREORGANIZE 
option is set. 
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COMPILER 2 QPTIONS 


The following describes the general syntax of the DASOL Compiler 
Control Options. 


$$--1 I [gm newen 5 cn anen|t | t 
! i { i 
[Ke ee en cere ennens womecceeeee wceeeneecnnna woo] 
! ! 
Jeown= <DASDL one-time option> ot<eeneeecee= >{ 
| i 
iresee SUAS, “Opt Ton> Seen ene se eens ae ees >| 
i es { 
[eer <DASDL option vatue>. “seese*s+<= poeta | 
i t 
lmnnn- SET seeceeen- ores esreerene- aseee=>] 
f t 
[on--- RESET -=->1 
t { 
le s<2° ONG: Sse = >I 


GENERAL SEMANTICS | 


le Every DASDL compiler control option card image must have a 
deltlar sign (8%) character in column 1.2 Columns 73-80 may be 
used as a sequence field. The card image is interpreted 
from teft to right beginning with the first character 
following the dollar sign character(s). . 


Ze Any DASDL option card image teginning with two consecutive 
adjacent dotlar stgn characters (£%) denotes a permanent 
DASDL option card tmagee which will be included in any new 
source file generated via the “NEW™ option. A single dollar 
sign ($) character denotes a temporary options the life of 
which is Limited to that of the current compile. 


3e DASDL onetime opions may be SET or RESET only oncesr and. 
such setting or resetting must occur before any DASDL source 
images are processed. Alt other DASCL compiler control 
options may he SET or RESET any rumber of times and anyuhere 
Within the DASDL source file. 
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he If a DASDL compiler control option appears without an 


explicit "SET™» "RESET"» or "NO"+ it is implicitly enabled. 


5. Parameters may or way not be required for any particular 
option. See the explanation for the item involved to 
determine the suitability of parameters. 


NOTE: Any option requiring parameters must be the last 
option to appear on. a DASOL comptler control card image. 


DASOL QNETTIME OPTIONS 


Parameters are not allowec unless otherwise specified.. Default 
setting is disabled for all options unless noted otherwise. 


CONVERT This option soecifies that the tnternal format of 
an existing data base dictionary must be modified 
to reflect the format required hy the current 
level of the MCP. Alt dicttonartes created 
previous to 8.9% must be converted to the 2&8.” 
dictionary format tn order to run on an 6.0 MCP. 
As conversicn is a self-contained processe no 
other input is accepted. Any DASDL source tmages 
following this card will be ignored. 


FILE See STRUCTURE. 

INITIALIZE When preceeded by "NO" or "RESET™» this option 
inhibits file inittalization following DASOL 
source encoding. This ootion 14s intended for 


development use cnly. 


MERGE This options when enabled» causes the DASDL 
compiler to merge source images from the primary 
input file C*"CARDS") together with source images 
from the secondary input file ("SOURCE"). 


NEW When “set™,» this option enables creation of a new 
source file (C*"NEWSOURCE”") containing all source 
images and permanent DASOL compiler control 


options processed from the primary and secondary 
input files. 


10-3 


BURROUGHS CORPORATION COMPARKY CONFIDENTIAL 
COMPUTER SYSTEMS GkOUP BLEOO/EL79C DASDL 
SANTA BARBARA PLANT . P.Se. 2219 0433 REV 8B 
REGRGANIZE This option enables reorganization of an existing 


SOURCE 


SOURCEQNLY 


STRUCTURE 


TABLESIZE <max 


TAPE 


data base. For more detailsr see the 81800781700 
DMSII REORGANIZATION document» P.S. 2219 AS5S4N, 


This option enables the printing of the COBOL 
library files generated by ODASOL in the output 
Listing for this compile. 


When enabled» this option causes DASOL to 
regenerate COROL and RPG tlibrary fites for an 
existing data base without recreating the data 
base. No cther functions are performed when this 
option is specifieder and no other source images 
will be processed. 


This option enables the’ printing of statistics 
from data base structure records that show the 


Layout of records. index tables, and list 
structures tnctuded in this data base. Since 
there is a one to one correspondence between 
structures and files» information cn files is 


included with the structure informaticn. 


tablesize> 


When enablede this option causes a limit to be put 
on the maximum size of all indexed sequential and 
indexed random sets in this data base. This limit 
may be overridden by an explicit MAXENTRIES 
declaration for any individual setr but serves as 
a bound for the defautt calculation for any set 
not exptlicitty specified. The <max tablesize> is 
a required parameters and indicates the maxinua 
size in disk seaments that the tables are allowed 
to attain. The maximum vatue for <max tablesize> 
is 45» the default value is 20. 


Used in conjunctton with "REORGANIZE™ to specify 
tape as the communication media for the data base 
reorganization programs. Default media for these 
programs 1s a queue file. 
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UPDATE <data base name> 


VERS ITONCHECK 


DASDL QPTIONS 


This option specifies that the data base source 
description be compared to and supercede the 
existing data hase description. UPDATE may be 
used in conjunction with the REORGANIZE option or 
by itself. Hhen used atone» the new description 
of the data base may specify new structures or 
exclude existing structures as long as these 
changes do not cause any restructuring of the 


continuing data hase. The <data base name> is an 
optional parameter?» and specifies the name cf an 
existing data tase which 18 to be updated. If 
omitted,» the data base name associated with this 
DASDL compite is assumed. Use of the data base 
name parameter has no effect on the names of the 
data base files being created. This optton,s if 


speci fied» must be the last option to appear on a 
compiler control card image. 


This option causes the runctime verification that 
the version Cdate and time of compile) associated 
with the CC8OL tibrary files of any application 
program attempting to access this data base is 
equal to that dssocitiated with the structures in 
the data hbase itself. The default setting for 
this option is enabled. ; 


Unless otherwise specified, att options default to disabled and 
do not allow parameters. . 


COBOL 


This option causes the DASDL compiler to check for 
COBOL reserved words which may occur as 
identifiers in the DASDL source. This prevents 
syntax errors from occuring in the COBOL library 
files generated by this compile. 


COBOLIB <fLogical data base name> 


This option causes DASOL to generate CCBOL Library 
files on disk for the logical data base specified. 
If <logicat data base name> is omitted» then the 
name of the ohysical data base is assumed. ' The 
COBCLIB option is set by default for the physical 
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CODE 


DEBUG 


DELETE 


DOUBLE 


INCLNEh 


data tase» but reset for all togical data bases. 


This option causes the ODASDL compiler to  oprint 
information about the DASOL generated code. Two 
tables are Listed. 


The first table lists each code segment and its 
S$1ZC. 


The second table Lists each structure by names and 
for each of the up to 6 kinds of coage that could 
be qenerated for a structures the seqment numter — 
of the segment that contains that particular type 
of code. | 


This is intended to be used in conjunction with 
SYSTEM/MARKSEGS. 


This option causes DASODL to inctude reorganization 
control information in the output tisting 
generated by this compile. This option is 
intended for development use only. 


When enableds this option causes the DASOL 
compiler to discard source images from the 
secondary input file ("SOURCE™") untit disabled. 
It must appear on a source image in the primary 
input file C"CARDS")» and has no effect 1f "MERGE" 
has not heen enabled. The normal merqing process 
wilt not be altered»e but att source ifiages 
Cincluding CASOL compiter control options) will oe 
discarded as they are read fror the secondary 
file. These source tmages will not be listed or 
carried forward into a new source file. 


When enableds causes the DASOL output Listing to 
be double spaced. 


This option» when enabled» causes any source 
images processed as a result of the "INCLUDE" 
option te be included in the new source file 
C™NEWSOURCE™) should the “NEH* option be enabled. 
If "NEW" 15 not enabled, this option has no 
effect. 
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INCLUDE <file~id> 


LIST 


LIST$ 


LISTINCL 


PAGE 


RPG 


When enabled» this option causes DASOL to suspend 
the normal sequence of processing source images 
and accept input from the file specified by 
<file-id> until such input is exhausted. Normal 
compilation is then resumed. The <file-id> is a 
required parameters andis in the normat fite 
identifier format cf <pack>/<mfid>/<fid>. This 
options if specified» must be the last option to 
appear on the compiler controt card imager and may 
not appear on a source image within ae “fite 
processed via the “JNCLUDE" optton. 


This option causes a Listing of all source images 
and permanent OASOL compiler option card images to 


be included in the output listing for this 
comptte. The default setting for this option is 
enabled. 


This option causes a tlListing of all temporary 
DASDL compiter control card images to be included 
in the output listing for this compile. If the 
LIST option is disabledre LISTS has no effect. 


When enabled» this option causes the inctlusicn of 
all source images processed via the “*INCLUDE*™ 
option in the cutput Listing for this compile. If 
the LIST option is disabled» LISTINCL has no 
effect. . 


When encountereds this option immediately causes a 
page advance to be placed in the output listing 
for this compile. 


This option causes the DASDOL compiter to check the 
database description for RPG compatibility», 
respecting identifter size and subscripting. 
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RPGLI68 <Logical data base name> 


SEQ or SEQUENCE 


SINGLE 


STANCARD 


SUPPRESS 


VOID <seq=no> 


This option causes MASDL to generate the RPG 
fibrary files on disk for the Logical data base 
specified. If <logical data base name> is 


omitted» then the name of the physical data base 


is assumed. The RPGLIB option is reset by default 
for the physical data base and alt logical data 
basese 


This optionr - when enabled» causes the ODASDL 
compiler to assign new sequence numbers to the 
source language card images accepted for input. 
This option assigns the Current Sequence Sase (see 
DASCL option values) to the current source images 
and increments the Current Sequence Base hy the 


Current Sequence Increment (Csee OASOL option 
values). 

When enabled» this option causes the compiler 
output listing to be single spaced. This option 


defaults to enabled. 


This option causes the DASDL compiler to enforce 
syntax rules as described by the Burroughs CASOL 
Standard. 


This option causes the DASDL compiler to suppress 
the inclusion of warning messages in the output 
listing for this compile. This option performs 
the same function. as “WARNSUPR®. 


This options when enabled-s causes all input images 
in the secondary source file C(™SGURCE™) to be 
discarded until <seq-=no> has been exceeded by a 
sequence nurber tn the secondary source file. The 
<seq-no> is an optional parameter and must be 8 
digits in length. If omitted» only the present 
card image will be discarded. 
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WHARNSUPR When enabled» this option causes. the DASDL 
compiler to suppress inclusion of warning messages 
in the output listing for this compile. See 
"SUPPRESS". 


DASDL OPTION VALUES 


These values are used by the ODASDL compiler to control 
resequencing» and may appear anywhere on a compiler control card 
image. They have no effect if the "SEO" option is not enabled. 


Current Sequence Base 


This is a 1 to 8 character string of digits 
signifying the current base sequence number from 
which resequencing will take place. The default 
value for this entity is "90001000", 


Current Sequence Increment 


This is a chardcter string comprised of a +t" 
character fecllowed by 1 to 8 digits signifying the 
current increment to be used in resequencing. The 
default setting for this entity is #1G00". 
Spaces may optionally appear between the +" 
character and the sequence increment. 
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CARDS 


CCGOL.~LIB 


DMS.~DICT 
OMS-OLC.CICT 


ERROR.LINE 


GUARDFILE 
LIBRARY 


LINE 


NEWSCURCE 


KREORG.CODE . 
REORG.FILE 


RPG.LIB 


DASOL EILES 


This is the primary source fite for the DASDL 
compiler. It is the first file to be read» and may 
contain the entire set. of source images to be 
processede Optionatly» Cif "MERGE" is enabled) it 
may contain patches to be applied to the secondary 
input file ("SOURCE"). 


The COBOL libtrary files created by DASDL are 
written serially to this file. 


This file is the data base dicticnary assoctated 
with the data base to be created by this OASDL 
compile. 


This file is an existing data base dictionary .which 
will be used by the DASDL compiler te create a new 
data base dictionary. 


This is the error message output file used in 
conjunction with compiles via CANDE. When a 
compile ts initiated from a termtnal through CANDE>s 


-or DASOL is executed with SW1 = Is alt error 


messages will be dumped to this file. 


This 1s a serial input file containing security 
access restricttons for the data base. 


This file contains source statement images to be 
processed via the "INCLUDE™ option. 


This ts the output Listing file» containing a list 
of processed source’ images. Its contents are 
controlled via the. “LIST™. “"LISTS™» and "“LISTINCL™ 
options. 


This is the output symbolic files a file containing 
those source tmages selected by DASDL in accordance 
with the “NEW"™ and “IACLNEW" options. 


This is an output file used for the creation of the 


REORG.READER and REORG.WRITER code files. 


This is an input file used for the creation of the 
REOQRG.REACER and REORG.~WRITER code files. 


The RPG library files created by DASDLE are written 
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SCLeFILE 


SOURCE 


serially to this file. | 


This 1S a random output file used for the creation 
of the data files for the data base being 
processed. 


This file is the secondary input filer which 
contains previously stored DASDL source images. It 
is not used unless the "MERGE" option 1s enabled. 


